ham software for the Palm

included are:
BD-Palm		Palm version of BD (Bearing Distance calculator)
lltogrid	lat & lon to grid
Log_10g		for the ARRL 10 GHz contest, 10 GHz only
Log10gup	for the ARRL 10 GHz contest, 10 GHz and up
Log_ARRL	for ARRL VHF contests (4 digit grids)
LogVHFup	6 digit grids
Log_MCMC	for the Millenial Cumulative Microwave Contest
Log_cum		I forget what's different!

these new logging programs feature a grid map that you tap to
enter nearby grids, and recall of last call for running bands

these were built with PocketC. a freeware runtime version is
included and needed to run the programs.  the Mathlib is also
required.

otherwise, they are similar to the original, described below

by Paul Wade W1GHZ copyright 1999, 2000
Released to the public domain August 2000

comments and suggestions to w1ghz@arrl.net

here is the blurb for the original, including
installation instructions

************************************************

Log10GHz for Palm Pilot

version 0.2 July 1999 initial public release.
version 0.3 (beta)  August 1999
- fixes a problem with the GMT offset getting lost.
version 0.4 August 1999
- now asks for other grid first, returns heading so you
  can aim the antenna, then asks for call to record QSO
  (thanks to Matt, KB1VC for suggestion: saves switching
   back and forth between BD and logging)
version 0.5 September 1999
- rejects calls with less than 3 characters.  the problem
  was after entering a grid, if the contact was not completed,
  it occasionally was logged with a blank call.

REMAINING BUG: the Palm MEMOPAD has a size limit per entry, which 
 translates into about 60 QSOs.  it puts additional QSOs into a
 sequential memo but displays them as one.  However, when exporting
 to a desktop file, only the first one is exported - the other has
 no visibility on the desktop.  
WORKAROUNDS:  1. rename the log file every 50 QSOs, stitch together
 later.
 2. export the log, go into MEMOPAD on the PALM and delete the QSOs 
   that were successfully exported (which brings the rest to the top),
   then export again to a different file, stitch files together.
 3. find a shareware MEMOPAD replacement without memory limits.  there
   are several out there, but I haven't tried one yet.

This is a tiny logging program for the Palm Pilot for the
ARRL 10 GHz &up Cumulative Contest.  Version 0.3 and up have two
separate logging programs:  10g_log for 10 GHz ONLY operation, 
to minimize input entries, and log_cum, a multiband version.
I used the multiband version for the 1999 UHF contest and the
10 GHz only version for the first weekend of the ARRL 10 GHz contest.

The logger only records the data, as a MEMO PAD record.  It can
be exported to a PC (or Mac) and postprocessed for scoring, either
manually or with the Perl script PALM2ARL.PL (see that readme).  
It could probably be done with a spreadsheet. 

some of the routines are translated from BD.PAS:

   PROGRAM Bearing_Distance;
                   {Determines bearing and distance based on}
                   {algorithm compensating for earth's shape}
                   {Copyright 1993 Michael R. Owen, W9IP & }
                   {               Paul Wade, N1BWT }
                   {Released to the public domain Feb 23, 1993}

                   {NOTE: NORTH latitude, WEST longitude apre positive;   }
                   {      South & East should be input as negative numbers}


to C by Matt Reilly KB1VC, then PocketC by Paul Wade W1GHZ.

*****
NOTE: PocketC is shareware, by Orbworks (www.orbworks.com), and
is required for BD_Palm to run.  You should register your copy
to be legal.
*****


TO INSTALL:

1. Install PocketC.prc on your Palm Pilot.

2. Install MathLib.prc on your Palm Pilot, if you don't
   have it already.
   
3. Install log_10g.prc on your Palm Pilot.
   (Multiband: log_cum.prc)

4. Tap the 10G icon.
   (Multiband: "Log" icon) 



RUNNING:

When the program starts, it asks for your call, then searches the MEMO PAD
for a record starting with the same string.  If it finds it, it asks for 
your current location, then proceeds to append additional contacts to the
log.  

If it does not find an existing log, it starts a new one, asking for your
GMT offset (I assume that your Palm Pilot is on local time and you wish to
log in Zulu).  Then you are prompted for your current location and can begin
loggin.

For each contact, you are prompted for a grid, then Bearing and Distance are
displayed. Next you are prompted for a call, [and band if multiband version] 
then asked to confirm the information before writing it to the log.  If you 
make a mistake, just enter "N" and re-enter the information.

Between contacts, you may simply turn off the Palm Pilot; it will power up
right where you left off.

If you move to a new grid, closing and restarting the program will prompt
for the new location.

The GMT offset (version 0.3+) is stored in a MEMO PAD record called GMTzone.
If you were to change timezones, you would have to manually edit the number
stored in this record.  The current GMT offset is displayed at startup.

QUIRKS:

1. The program does minimal checking for grid format only.  Anything else gets
entered, but you can easily edit the log in the MEMO PAD.

2. The GMT conversion does not adjust the date; i.e., if you log a contact
at 10:23 PM EDT, it will be logged as 2623Z on the current local date.  This
is much easier to fix in a postprocessor.

3. No Daylight Savings Time adjustment.  When it changes, or if you move to a 
new time zone, edit the GMT offset in the MEMO PAD record called GMTzone.  It
is an integer on the second line.

4. The band entry in the multiband version is simply a string, with no checking.
You may enter frequency, wavelength, ARRL alphanumeric band designators, or 
anything else you like.  Fix it later in postprocessing.  [Note that this means
you are not limited to microwaves -- you could enter 160M, another contest that
uses grid squares.]

COMPILING:

If you want to fiddle with the program, you may recompile.  

1. Rename the source files to *.txt

2. Load each source file to the Palm Pilot as a separate memo
   in MEMO PAD.
   
3. Start PocketC and compile.


ENHANCEMENTS:

This is intended to be a small, easy to use logging program.  This program only
takes 6K of storage.  Try that with Windows!

version 0.4 is up to 7K with bearing calculation.


COMMENTS and BUG REPORTS to wade@tiac.net
